Skip to content

Add Docker Images Management Feature #863

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom
Open
felix068 wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Add Docker Images Management Feature #863

felix068 wants to merge 1 commit into from

Conversation

@felix068
Copy link

@felix068 felix068 commented Oct 5, 2025 •
edited
Loading

⚠️⚠️⚠️ Since we do not accept all types of pull requests and do not want to waste your time. Please be sure that you have read pull request rules:
https://github.com/louislam/dockge/blob/master/CONTRIBUTING.md

Tick the checkbox if you understand [x]:

  • I have read and understand the pull request rules.

Description

Adds a comprehensive Docker images management interface to Dockge. Users can now view, pull, build, delete, and prune Docker images directly from the web UI. The interface also displays Docker disk usage statistics and includes search/filter functionality.

This addresses multiple user requests for better image management capabilities.

Features:

  • View all Docker images with details (repository, tag, ID, size, creation date)
  • Pull images from Docker registries with progress indication
  • Build images from Dockerfile content
  • Delete individual images with proper error handling
  • Prune unused images with warning dialogs
  • View Docker disk usage statistics (images, containers, volumes, build cache)
  • Search/filter images by repository, tag, or ID

Type of change

  • User interface (UI)
  • New feature (non-breaking change which adds functionality)

Checklist

  • My code follows the style guidelines of this project
  • I ran ESLint and other linters for modified files
  • I have performed a self-review of my own code and tested it
  • I have commented my code, particularly in hard-to-understand areas (including JSDoc for methods)
  • My changes generate no new warnings
  • My code needed automated testing. I have added them (this is optional task)

Screenshots (if any)

image

@felix068 @claude
Add Docker images management feature
deab3ab 
This commit adds a comprehensive Docker images management interface to Dockge, allowing users to:
- View all Docker images with details (repository, tag, ID, size, created date)
- Pull images from Docker registries
- Build images from Dockerfile content
- Delete individual images
- Prune all unused images
- View Docker disk usage statistics (images, containers, volumes, build cache)
- Search/filter images

## Backend Changes
- Added 6 new socket event handlers in `docker-socket-handler.ts`:
  - `getDockerImageList`: List all images
  - `deleteDockerImage`: Remove an image by ID
  - `getDockerDiskUsage`: Get disk usage stats
  - `pullDockerImage`: Pull image from registry
  - `buildDockerImage`: Build from Dockerfile
  - `pruneDockerImages`: Remove unused images
- All methods include proper error handling with real Docker error messages
- Full JSDoc documentation for all methods

## Frontend Changes
- New page: `Images.vue` with StackList-inspired design
- Integrated search functionality
- Progress indicators for pull/build operations
- Dark theme support
- Responsive layout

## Features
- Real-time error messages from Docker (not generic errors)
- Proper handling of images in use by containers
- Progress bar for long operations (pull/build)
- Warning dialogs for destructive operations
- Consistent UI/UX with existing Dockge interface

## Translation
- Added 23 new translation keys in `en.json` only
- No other languages modified (as per contribution guidelines)

All changes follow CONTRIBUTING.md guidelines:
- 4-space indentation ✓
- camelCase for JS/TS ✓
- kebab-case for CSS ✓
- JSDoc documentation ✓
- No new dependencies ✓
- Consistent UI styling ✓

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>
@authrequest
Copy link

authrequest commented Oct 26, 2025

Did you even check if this still runs and there are no errors since you used Claude

@felix068
Copy link
Author

felix068 commented Oct 27, 2025 •
edited
Loading

@authrequest
that's why usually i don't mention that it's made with claude, because instantly the anti-ai people think it's done by a non-dev and "vibe coder"...
Of course i checked how it works and fixed some issues myself, you can also give me feedback (more constructive than this one, if possible) on problems in the code

@SootyOwl
Copy link

SootyOwl commented Dec 16, 2025

This is looking great. Would it be possible to add management across agents when using 1.4.0's multiple agents support? Maybe in a tabbed UI or something.
I'd do this myself but I'm very busy at work haha.

@regalen
Copy link

regalen commented Dec 21, 2025

Will this be merged into main for release? this is the one feature that keeps me using portainer alongside dockge as i prefer a GUI to view images and prune orphaned images.

@meiser79
Copy link

meiser79 commented Jan 12, 2026

Hi, I'm using @cmcooper1980's docker image "image-management". The list under "Docker Images" shows images to be pruned which are currently in use, and there's no older image. Is that intentional? What info shall I provide to analyse this issue?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@felix068 @authrequest @SootyOwl @regalen @meiser79